Release 10.1A: OpenEdge Development:
Java Open Clients


Deploying an Open Client application that uses a Java proxy

To deploy a client application that uses a Java proxy, you must first perform the following steps in the specified order, on the system where you plan to run the application.

To deploy a client application that uses a Java proxy:

  1. Install a Java Virtual Machine (JVM). Many platforms already come with a JVM. For more information on the available Java run-time environment (JRE) for your platform, see the sections on Java requirements in OpenEdge Getting Started: Installation and Configuration .
  2. Copy the required files for the client application and proxy to the deployment system:
    1. Copy the client application.
    2. Copy the proxy .class files to a directory that mirrors the package hierarchy specified on the Java tab of the Generate dialog box in ProxyGen during the generation of the proxy. The package name implies a directory structure that you must maintain when you copy the proxy. You also can put the class files into a .zip or .jar file, as with any other Java classes.
    3. Copy the same Java Open Client Runtime package that you used to build the application to any directory on your system. See the "Building an Open Client application that uses a Java proxy" section.
    4. Copy the following third-party Eclipse jar files to the same directory where you copied the Java Open Client Runtime package in Step c, above. These files reside in the specified OpenEdge installation directory:
    5. OpenEdge-install-directory/java/ext/ 
          common.jar 
          commonj.sdo.jar 
          ecore.jar 
          ecore.change.jar 
          ecore.sdo.jar 
          ecore.resources.jar 
          ecore.xmi.jar 
      

  3. Update the CLASSPATH setting for the Java environment that will run the client application to include the following:
    1. The client application classes.
    2. The directory containing the proxy (.class files) or the .zip or .jar file from
      Step 2. For class files, this is the directory above the package hierarchy.
    3. The Open Client Runtime package and Eclipse jar files you copied in Step 2.
    4. Note: The mechanism to update the CLASSPATH setting depends on the Java environment you are using. For instructions on updating CLASSPATH, see the documentation for your Java environment.

  4. If you use HTTPS (SSL), copy your digital certificates to the location required by your application. The Open Client Toolkit includes the certificate management tool (procertm utility), which provides a way to import, export and remove certificates to and from .jar and .zip files. See Appendix B "Java Open Client Certificate Management Utility."
  5. Run your Java Open Client application as designed.

Copyright © 2005 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095